home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / CAD_CAM / GSMAP8 / README < prev    next >
Text File  |  1992-03-05  |  38KB  |  687 lines

  1.  
  2.  
  3.  
  4.  
  5. UNITED STATES DEPARTMENT OF THE INTERIOR
  6. GEOLOGICAL SURVEY
  7.  
  8. SYSTEM 8.  GSMAP, GSMEDIT, GSMUTIL, GSPOST, GSDIG AND OTHER 
  9. PROGRAMS VERSION 8,  FOR THE IBM PC AND COMPATIBLE 
  10. MICROCOMPUTERS, TO ASSIST WORKERS IN THE EARTH SCIENCES
  11.  
  12. by
  13. Gary I. Selner and Richard B. Taylor
  14.  
  15. Open-File Report 
  16. 92-217
  17.  
  18. DISCLAIMER
  19.  
  20. Although program tests have been made, no guarantee (expressed or 
  21. implied) is made by the authors or the U.S. Geological Survey 
  22. regarding program correctness, accuracy, or proper execution on 
  23. all computer systems.  Any use of trade names is for descriptive 
  24. purposes only and does not imply endorsement by the U.S. 
  25. Geological Survey.  This report has not been reviewed for 
  26. conformity with the U.S. Geological Survey editorial standards.
  27.                            Denver, Colorado
  28.                             February, 1992
  29.  
  30. AVAILABILITY:  
  31.  
  32. Open File Reports can be purchased at the address given below: 
  33. Books and Open File Reports Section
  34. U.S. Geological Survey
  35. P.O. Box 25425, Denver, CO 80225,  
  36. (303)-236-7476
  37.  
  38. README FILE
  39.  
  40.      This  file  is  NOT  intended as a replacement  for  the  program 
  41. documentation.   The  documentation consists of 220 pages of  detailed 
  42. instructions with over 40 illustrations.   It is virtually  impossible 
  43. to  learn  these programs without access to  the  documentation.   See 
  44. Availability above for where to purchase the documentation.
  45.  
  46.  
  47.  
  48. TABLE OF CONTENT FOR THIS FILE
  49. SECTION 1 - HARDWARE AND SOFTWARE REQUIREMENTS
  50. SECTION 2 - BRIEF DESCRIPTION OF PROGRAMS
  51. SECTION 3 - CONTENTS OF RELEASE DISK
  52. SECTION 4 - INSTALLATION OF SOFTWARE 
  53. SECTION 5 - HARDWARE ISSUES UPON INSTALLATION
  54. SECTION 6 - UPGRADING ISSUES
  55. SECTION 7 - ADVICE FOR NEW USERS
  56.  
  57. SECTION 1 - HARDWARE AND SOFTWARE REQUIREMENTS
  58.  
  59.      GSMAP  and  accompanying  programs  in  this  release  have  been 
  60. designed for use on IBM compatible personal computers.   Many of these 
  61. programs require a digitizer and plotter.  A complete system includes:
  62.  
  63. HARDWARE
  64.  
  65. Microcomputer     
  66.      The  microcomputer must use the DOS operating system Version  2.0 
  67. or higher,  at least 512K available RAM,  two floppy disk  drives,  or 
  68. one and a hard disk; at least one serial port, better two (one for the 
  69. digitizer,  the  other  for the plotter);  one parallel port (for  the 
  70. printer);  math co-processor chip to match the system;  graphics card, 
  71. IBM compatible CGA,  EGA,  VGA,  Hercules monochrome; monitor suitable 
  72. for use with the graphics card.   Although CGA graphics will work they 
  73. are not adequate to exploit the graphic capabilities of this  version.  
  74. EGA  or  VGA color graphics will display different kinds of  lines  in 
  75. different colors.   EGA and VGA color graphics adapter cards must have 
  76. at least 256K memory to plot color on screen in EGA/VGA modes.  A hard 
  77. disk  or  other  fast-access storage device is  strongly  recommended.  
  78. These  programs have been successfully operated on  Compaq,  Columbia, 
  79. Hewlett Packard, Sperry, IBM, GRID, Tandon, Zenith, Northgate, Leading 
  80. Edge,  Gateway,  and other computers,  and should operate on any fully 
  81. compatible computer.   We have run the programs on computers that  use 
  82. the  8088 chip and 8087 co-processor at 4.77 Mhertz to others that run 
  83. the 80486 at 33 Mhertz.  
  84.  
  85. Printer
  86.      The  printer must communicate with the computer through  parallel 
  87. port #1 (LPT1:), there are no special requirements for the printer.
  88.  
  89. Digitizer
  90.      A  16-button cursor is strongly advised (but not required  except 
  91. for  GSSECT).   GSMAP and GSDIG have been designed and tested using  a 
  92. GTCO  DIGI-PAD  digitizer with a 16 button cursor  and  a  Summasketch 
  93. Professional  digitizer  with  a  4 button  cursor.   They  have  been 
  94. successfully  operated  with Calcomp,   Numonics (some  in  menu  mode 
  95. only),  Summagraphics  Microgrid  II,  and  other  digitizers  to  our 
  96. knowledge,  and  probably  can be used with any digitizer  that  sends 
  97. ASCII  character strings and communicates with the PC through an RS232 
  98. serial port.
  99.  
  100. Plotter
  101.      Plotters  must support the HPGL plot language at a level  of  the 
  102. HP7475 or above, and the cable connecting the computer and the plotter 
  103. must  be  correctly configured.   Our tests have been conducted  on  a 
  104. Hewlett Packard 7585B and HP-7550A plotters.   The HPGL files that are 
  105. generated   by  these  programs  can  be  used  by Laser  printers;   the 
  106. illustrations  in  the documentation of this release were  printed  in 
  107. this way.
  108.  
  109. Mouse
  110.      A  Microsoft-compatible  mouse can be used as a  pointing  device 
  111. with  the GSMEDIT,  GSMPBS,  and GSPOST programs.   Use of a mouse  is 
  112. convenient and speeds certain operations, but these three programs can 
  113. be fully operated without a mouse using the arrow keys on the keyboard 
  114. to move cursors on the screen.  
  115.  
  116. SOFTWARE
  117.  
  118.      The  minimum software requirements for utilizing  these  programs 
  119. include  PC/DOS  2.0  or  higher or equivalent  MS  DOS,  the  release 
  120. diskettes,  and  a word processing program capable of producing  ASCII 
  121. files.  Although a RAM-resident program such as SIDEKICK is useful, it 
  122. can  play  havoc  at  unexpected times  due  to  memory  conflicts  if 
  123. installed  in base memory.   We recommend running systems without  TSR 
  124. (terminate and stay resident) or RAM resident programs.  
  125.  
  126. SECTION 2 - BRIEF DESCRIPTION OF PROGRAMS
  127.  
  128. SYSTEM 8
  129.      This  release  of  GSMAP  SYSTEM 8 brings together  a  series  of 
  130. programs for IBM PC (and compatible) microcomputers with familial ties 
  131. to GSMAP .   All have been revised from previously published  versions 
  132. or   are  new  to  this  release.    All  use  Version  8  (CONFIG8.*) 
  133. configuration  files.   All use the same hardware system.   The  links 
  134. between these programs are more apparent when grouped together than as 
  135. previously released as a series of separate reports.  
  136.  
  137.      The basic set of geologic symbols and fonts are also used by  the 
  138. other programs in this release.   Symbols definitions are contained in 
  139. an  ASCII  file  that can be extended or modified by  the  user,  line 
  140. patterns also can be modified, within the scope of the Hewlett Packard 
  141. pattern set.  The documentation contains instructions on how to design 
  142. new symbols.
  143.  
  144.      All output can be drawn on a plotter,  on the screen or sent to a 
  145. disk  file  using  HPGL  (the  Hewlett  Packard  Graphics   Language), 
  146. including  text and symbology.   The on-screen graphics can be used to 
  147. assist digitizing, editing, and design of output.  All of the programs 
  148. in  this  set can use  either Cartesian data  (X,  Y  coordinates)  or 
  149. geodetic  data  (latitude,  longitude  coordinates).   The  choice  of 
  150. coordinate system is made by the user.  Cartesian coordinates are most 
  151. useful   for   illustrations,   cross   sections,   and   maps   where 
  152. latitude, longitude  coordinates  are unavailable,  where the use of  a 
  153. geodetic system adds unneeded complexity, or where it lacks sufficient 
  154. precision  (e.g.  a map at a scale of 1 inch equals  1  foot).    When 
  155. working  with geodetic coordinates,  these programs support  Mercator, 
  156. Universal Transverse Mercator,  Transverse Mercator, Oblique Mercator, 
  157. Lambert  Conformal Conic,  Albers Equal Area,  Equidistant Conic,  and 
  158. Polyconic  map projections.   Design goals required an  "office-scale" 
  159. hardware system with an affordable price.  All of the programs operate 
  160. from menu screens.   On-screen messages prompt the user at appropriate 
  161. times.   Responses from the keyboard are entered by typing appropriate 
  162. answers to the prompts,  and then screen.  These programs are oriented 
  163. for  use  by  geologists  and  other  scientists,   not  for  computer 
  164. specialists.  Programming skills are not required.  
  165.  
  166.  
  167. GSMAP
  168.      GSMAP and related support programs  including  GSMEDIT,  GSMUTIL, 
  169. GSMPBLD  and  GSMPBS  have  been developed to  assist  geologists  and 
  170. illustrators in compilation and publication drafting of geologic  maps 
  171. and illustrations.   These programs attempt to facilitate geologic map 
  172. compilation  and  drafting  in the way that  digital  word  processing 
  173. facilitates  composition and editing of text.   As a set of  practical 
  174. graphics  programs,  they  enable  digital  compilation  of  graphical 
  175. elements,  ease  the  process  of modification in response  to  second 
  176. thoughts, editorial comments, and scale changes, and lead from initial 
  177. compilation to publication without redigitizing or redrafting.   GSMAP 
  178. uses a high precision digitizer and plotter for entry and plotting  of 
  179. digital data.  Program capabilities include modification of data bases 
  180. by deletion of unwanted entries or additions at any time.  Part or all 
  181. of  the  data in a data base can be plotted.   Words and  alphanumeric 
  182. characters  are  entered into an ASCII file using  a  word  processing 
  183. program,  and their locations are entered by digitizing.   Entries are 
  184. numbered  by  the  program  and can be edited or  deleted  using  this 
  185. number.   Although the primary output is to the plotter,  plots of all 
  186. data can be drawn on the screen.   Plots can be made in two modes; the  
  187. "draft"  mode  provides entry numbers,  the "publication"  mode  draws 
  188. plots  without  entry  numbers.   GSMAP  data  bases  using  the  same 
  189. coordinate system can be merged.   GSMAP supports lines of 14  pattern 
  190. types,  symbols, patterning of polygonal  areas, text (with leaders if 
  191. needed),  multi-line text entries,  and text that flows along features 
  192. such as rivers, fault lines, etc.
  193.  
  194.      The  documentation provides a thirty page tutorial that leads key 
  195. stroke  by keystroke through the digitizing and plotting of  a  simple 
  196. illustration  that  contains the elements of a geologic  map.   For  a 
  197. person  who  understands DOS and a modern word processing program  the 
  198. tutorial exercise requires approximately two hours to  complete.   Our 
  199. internal training course is heavily oriented to hands-on participation 
  200. and  consists  of two eight-hour days of lectures and  exercises  with 
  201. approximately two hours dedicated to a discussion of projections.
  202.  
  203. GSMROSE 
  204.      GSMROSE  is  a  program for construction of  rose  diagrams  from 
  205. linear   data (lines or polygon boundaries) in GSMAP data bases.   The 
  206. user can specify the radius of the diagram, the angular measure of the 
  207. sector used for analysis, and output to the screen, to a plotter, to a 
  208. disk  file  written  in HPGL,  or to a GSMAP data  base  in  Cartesian 
  209. coordinates (new to this version).   After drawing the rose diagram, a 
  210. table  can  be printed that provides the numeric information  used  in 
  211. constructing  the diagram.   Two methods of analyzing the linear  data 
  212. are provided,  one length weighted,  the second, count weighted.  When 
  213. using  the  length-weighted option the program reads the  data  for  a 
  214. specified  code (lines or polygon margins) in a data base,  calculates 
  215. the  bearing  and  length of each interval between  points  along  the 
  216. lines,  accumulates these lengths for angular sectors of bearing  0-10 
  217. and  so  on  through 175-180),  calculates the total  length  of  line 
  218. segments in each sector,  and divides the length in each sector by the 
  219. length in the maximum sector.   This ratio is used in the rose diagram 
  220. as  the  radius  for the sector.   The radius of the diagram  for  the 
  221. sector of maximum length is chosen by the user.   For data bases  that 
  222. use  Cartesian  coordinates the Y coordinate of the data base is  used 
  223. as the Y coordinate (0 degrees) for the rose diagram.
  224.  
  225.      When using the count-weighted option,  the program reads the data 
  226. for lines (not closed polygons) with a specified code,  calculates the 
  227. bearing  of the line connecting the first and last point of the  line, 
  228. and  records  the  number of entries for each 5  degree  sector.   The 
  229. sector containing the most entries is plotted to the radius specified, 
  230. the  others  are scaled to this distance according to  the  number  of 
  231. entries.   For  geodetic  coordinates  and  most  of  the  projections 
  232. supported by the GSMROSE program the line of longitude used as central 
  233. meridian  in the projection parameter file is used as the Y coordinate 
  234. (0 degrees) for the diagram.  
  235.  
  236.      GSMROSE  Version  8.0 is a modification of  GSMROSE  Version  1.0 
  237. adding  the  ability  to export a GSMAP data base and  providing  full 
  238. compatibility with GSMAP Version 8.0.
  239.  
  240. GSSECT 
  241.      Generation  and  plotting of the topographic  profile  for  cross 
  242. sections,  and other profiles drawn from contour maps.  Version 8.0 of 
  243. this  program  has been revised from Version 2.0 so that it  uses  the 
  244. same  configuration  files  as  GSMAP Version  8,  to  interface  with 
  245. digitizers and plotters.  It can plot sections to the screen, to files 
  246. written in HPGL (Hewlett Packard Graphics Language),  drive  plotters, 
  247. or generate a GSMAP data base in Cartesian coordinates.    Drawing the 
  248. topographic  profile for structure sections is a chore not relished by 
  249. most  geologists,  and with conventional drafting techniques is  beset 
  250. with  pitfalls and inaccuracies.   The use of a precise digitizer  for 
  251. data  input  and of a plotter to draw the section eliminates  most  of 
  252. these problems,  and speeds the entire process.   Using GSSECT Version 
  253. 8.0,  a topographic profile may be drawn along a straight line,  along 
  254. connecting straight line segments,  such as a section with a bend,  or 
  255. along  a  curve (many short line segments),  such as the course  of  a 
  256. stream.   The  gradient  between  points of  known  elevation  can  be 
  257. computed, printed, and plotted to assist analysis of a profile.
  258.  
  259.      GSSECT  Version  8.0   is a  modification of GSSECT  Version  2.0 
  260. providing full compatibility with GSMAP Version 8.0.  
  261.  
  262. GSDIG 
  263.      GSDIG  is  a  program  used  to  determine  geodetic   (latitude, 
  264. longitude)  coordinates or Cartesian (X,  Y) coordinates from maps  or 
  265. drawings  and create ASCII character files containing site identifiers 
  266. and  geodetic coordinates (degrees,  minutes,  seconds)  or  Cartesian 
  267. coordinates  in  units  from the drawing or digitizer  units  (usually 
  268. inches).   Geodetic  coordinates for points can be digitized from  any 
  269. map  that has latitude/longitude coordinates for four points  and  has 
  270. been drawn using one of the supported map projections.
  271.  
  272.      The  output format for ASCII files can be chosen to provide  easy 
  273. input  of data to spreadsheet,  data base management programs,  or  to 
  274. geodetic  or Cartesian data bases in GSMAP format.   Alphanumeric site 
  275. identifiers  are in part entered from the computer keyboard  computer, 
  276. in part entered from the digitizer keypad.   An option in the  utility 
  277. program,  GSMUTIL,  is  included so that digitized geodetic (latitude, 
  278. longitude) or Cartesian (X,Y) data in GSPOST format or can be directly 
  279. entered  into a GSMAP data base.    Data from a series of maps can  be 
  280. digitized  and  the data stored in a single output file  in  a  single 
  281. digitizing session without leaving the program.   Alternatively,  data 
  282. can  be  added to an existing file permitting use of a single file  in 
  283. several digitizing sessions.   Use of a "mask" composed of prefix  and 
  284. suffix  entered from the keyboard permits alphanumeric identifiers for 
  285. sites  to be entered from the numeric keypad of the  digitizer  during 
  286. digitizing.   The prefix, maximum number of digits, and the suffix can 
  287. be changed during digitizing without reentering the coordinates of the 
  288. corners of the map.
  289.  
  290.      GSDIG  Version  8.0  is a  modification of GSDIG Version 3.03  to 
  291. provide compatibility with GSMAP Version 8.0.  
  292.  
  293. GSPOST
  294.      GSPOST  is  a program that takes data from a  properly  formatted  
  295. ASCII file and plots on the screen,  on a plotter, or writes to a disk 
  296. file  in  HPGL  (Hewlett  Packard  Graphics  Language)  to  make  maps 
  297. displaying  information  associated with geographic sites  by  drawing 
  298. symbols and/or posting numerical data.  GSPOST operates with data sets 
  299. that  use  latitude  and  longitude  (geodetic)  coordinates  or   X,Y 
  300. (Cartesian) coordinates.   The sites might be sample localities, drill 
  301. holes,  or  mine portals,  but characterized by location in  latitude, 
  302. longitude  or  X,Y coordinates and a site identifier,  and usually  by 
  303. numeric values for attributes of the site,  such as chemical data from 
  304. a sample site, or flow rates from a well.  
  305.  
  306.      The user must supply an ASCII data file that contains a series of 
  307. rows and columns.  Each row contains a series of attributes that apply 
  308. to one data point.   Each column contains one kind of attribute.   The 
  309. first  columns of each row are "control" columns providing the  site's 
  310. identifier,  the  coordinates of the site and the position  and  angle 
  311. posting  numerical values.   Additional columns to a total of 50,  are 
  312. data  columns.  Geodetic coordinates can be in either decimal degrees, 
  313. or in degrees, minutes, and seconds.  Both formats cannot be used in a 
  314. single file.  X,Y coordinates are specified in a system appropriate to 
  315. the map;  these cannot be mixed with latitude,longitude coordinates in 
  316. a single data file.  
  317.  
  318.      GSPOST allows the user to specify the column from which data will 
  319. be selected,  values or ranges in values (class intervals), and choose 
  320. different symbols (and/or different symbol sizes for each class,  with 
  321. or  without  posting  of numerical values,  or  the  posting  of  site 
  322. identifiers. 
  323.  
  324.      The  position  of posting of numerical data at each site  can  be 
  325. adjusted  to reduce over-printing of numbers by changing the  position 
  326. and/or  the angle of the posting.   These adjustments are made by  on-
  327. screen editing.  For any given map the X and Y scales are independent; 
  328. the  area  is specified using the coordinates of corner points in  the 
  329. coordinate system chosen for locating data points  (latitude,longitude 
  330. or X,Y). 
  331.  
  332.      GSPOST   Version  8.0  is a  modification of GSPOST Version  3.0, 
  333. adding  the  ability to register a plot to a specific  position  on  a 
  334. sheet  in  a  plotter,  allowing annotation of one line  of  the  plot 
  335. control  file  to  assist in keeping track of the purpose  of  a  plot 
  336. control  file,  and  the  ability  to  print that  line  as  a  title, 
  337. supporting the use of a mouse as a pointing device, and providing full 
  338. compatibility with GSMAP Version 8.0.  
  339.  
  340. SECTION 3 - CONTENTS OF RELEASE DISK
  341.  
  342. The  release diskette contains a self-extracting archive SYS8.EXE  and 
  343. this README file.  
  344.  
  345. SECTION 4 - INSTALLATION OF SOFTWARE 
  346.  
  347. 1.  Create a directory called GS on your hard disk (DOS MKDIR 
  348. command).
  349. 2.  CD \GS
  350. 3.  Insert the release diskette in the appropriate drive, e.g. A:
  351.  
  352.     Type A:SYS8 and depress the ENTER key
  353.  
  354.     The  files  on  the release diskette will be added  to  your  hard     
  355. disk in extracted  form ready for use.    About 1.6 Mbytes     will be 
  356. required.
  357.  
  358. 4.  Edit  your  AUTOEXEC.BAT  and  add  directory  C:\GS  to  the     
  359. current search list.
  360. 5.  Add a new line to your AUTOEXEC.BAT that reads as follows:
  361.     SET GSFILES=C:\GS
  362.  
  363. Many of the files on the release disk are used in the tutorial or  are 
  364. provided as examples.   After you are familiar with the programs,  you 
  365. can remove all files except for the following:
  366.  
  367.      Files with extension of EXE
  368.      Files with extension of FNT
  369.      Files with filename of CONFIG8
  370.  
  371. Normally  you  will  operate  the programs from a  directory  that  is 
  372. created  and  used  for  a specific  project  or  unit  of  work.   By 
  373. organizing  your hard disk as suggested above,  your working directory 
  374. will  contain  only  data files that can be removed  (or  archived  to  
  375. floppy disk) upon completion of the project.
  376.      
  377. SECTION 5 - HARDWARE ISSUES UPON INSTALLATION
  378.  
  379.      The  files  CONFIG8.SCR,  CONFIG8.DIG,  and CONFIG8.PLT  must  be 
  380. configured to match your hardware system.  Details are provided in the 
  381. section  "Hardware installation and configuration files" beginning  on 
  382. p. 154 of the documentation.  
  383.  
  384.      Refer  to  the section starting on page 15  for  installation  of 
  385. hardware.   Use the worksheet p.  156 to record the parameters of your 
  386. system.   Pay  special  attention  to  the  details  on   CONFIG8.SCR, 
  387. CONFIG8.DIG,  and  CONFIG8.PLT  to  match the physical setup  of  your 
  388. system.   These  modifications  can  be made  using  a  standard  word 
  389. processing program.   Check p.  19  about the use of the menu template 
  390. for  digitizers with less than 16 keys,  and even for use with 16  key 
  391. digitizer keypads if different ASCII codes aren't sent by each key, or 
  392. if  different numbers of characters are sent by different  keys.   See 
  393. also   p.   167  for  special   requirements  for  Hercules   graphics 
  394. (monochrome). 
  395.  
  396. SECTION 6 - UPGRADING ISSUES
  397.  
  398.      Important changes from GSMAP Version 7.0 are:
  399.  
  400. 1.  An  environmental  variable  can be used to  specify  a  directory 
  401. CONFIG8.PLT,  CONFIG8.SYM,  and  CONFIG8.SCR),  and font files (*.FNT)  
  402. and the addition of a statement of location e.g.  SET GSFILES=C:GS  to 
  403. the  AUTOEXEC.BAT  file allows these files to be kept in   a  separate 
  404. area  from the executable program files and data files,  and allows  a 
  405. single  copy to be maintained on disk for all of the level 8  programs 
  406. of the GS series.
  407.  
  408. 2. An additional capability added to the plotter option makes indexing 
  409. to hard copy in the plotter both feasible and accurate.   For example, 
  410. geologic  information  can  be plotted directly on a  topographic  map 
  411. base.
  412.  
  413. 3.  Polygons can be outlined with a different line type than that used 
  414. for  the fill.   Codes 400-499 and codes 800-899 have been defined  as 
  415. polygon  codes to increase the total possible number of polygon  codes 
  416. from 100 to 200.
  417.  
  418. 4.  Font  0  (0.FNT) has been expanded so that most  of  the  extended 
  419. character  set corresponds to the character set viewed on the  screen, 
  420. with geologic extensions in place of little used characters.  
  421.  
  422. 5.  Codes  100-199  used  for  data to be  plotted  from  tables  have 
  423. previously been restricted to one-point entries.   In this version two 
  424. points  can  be  digitized,  the first controls the  location  of  the 
  425. symbol, the second locates the posting position.
  426.  
  427. 6. Application programs and utility programs published separately have 
  428. been combined with this release. 
  429.  
  430. 7.  The  utility  program GSMUTIL supports added options  that  enable 
  431. listing of codes and number of entries in a data base.
  432.  
  433. 8.  GSMAP  option  8  (PLOT) GSMEDIT,  and GSPOST  now  contain  error 
  434. checking  for plot control files.   The plot file is rapidly  scrolled 
  435. across the screen,  but stops when an error is detected,  and requests 
  436. modification of the plot control file,  greatly assisting the location 
  437. (and hence fixing) of errors. 
  438.  
  439. 9.  GSMEDIT,  GSMPBS,  and GSPOST now support the use of a mouse as  a 
  440. pointing device for moving around the graphics screens.  
  441.  
  442. 10. At many points in the programs, prompts indicate choices that have 
  443. default values (hit the ENTER key).   Default choices are indicated in 
  444. Upper  case  letters;  lower  case letters designate the  other  valid 
  445. choices.
  446.  
  447. 11. Because of the introduction of the mouse pointing device in several
  448. of the programs (and the subsequent use of the right hand to hold the 
  449. device), a different system of choosing options has been introduced.  
  450. Previously you chose an option by typing a letter or number and then
  451. depressed the ENTER key.  The new procedure (identified on screen) is
  452. to chose the option by typing the letter or number only.  The programs
  453. will react as soon as a "hot key" is typed.  "Hot Keys" are displayed
  454. in an alternate color and a message on the lower right of the screen
  455. will indicate that the selection uses the "hot key" method.  When the
  456. word ENTER appears on the prompt, then the requested information should 
  457. be typed and then the ENTER key depressed to relay the information to
  458. the program.
  459.  
  460.      Before  starting  a new project using Version 8.0 or  resuming  a 
  461. Version 6/7 project using Version 8.0,  prepare,  or check and  modify 
  462. the following files.  
  463.  
  464.      Projection  parameter  file.   Use  the extension  .PRJ  to  take 
  465. advantage of on-screen file listings.   Projection files have not been 
  466. changed from Version 6/7.  
  467.  
  468.      Text file(s), as needed.  No change from Version 6/7.
  469.  
  470.      Data file(s), as needed.  No change from Version 6/7.
  471.  
  472.      Plot  control file(s) Changed from Version 7 only for codes  400-
  473. 499.   As with Version 7, you will need at least one plot control file 
  474. to operate these programs.   Use the extension .PLT so that it will be 
  475. listed  at  appropriate times.   You must have a plot control file  to 
  476. plot to the screen, on the plotter, or to a disk file, and to digitize 
  477. data  to  take  advantage of the screen display  capabilities  new  to 
  478. Version 7,  continued to Version 8,  and to use the new version of the 
  479. screen edit program GSMEDIT.  
  480.  
  481.      Look  in  the documentation for changes in requirements  of  plot 
  482. control files from Version 6.   Check decorated lines codes 1-99, 600-
  483. 699,  polygon  fills codes 400-499,  to specify the width and size  of 
  484. characters codes 100-199,  and for the new capabilities of these  code 
  485. groups.   Take  out  the line in the Version 6 plot  files  specifying 
  486. width and height of characters.
  487.  
  488.      In  versions of GSMAP prior to Version 7.0,  unused (extra) codes 
  489. in a plot file required the system to rummage all the way through  the 
  490. data base when plotting, find that no entries were present, then do it 
  491. all over again.  Version 7 and 8 operate differently.  Unused codes in 
  492. the plot file have almost no effect on the time of plotting.   Entry 1 
  493. in  the  data  base  is plotted  first,  then  succeeding  entries  in 
  494. sequence.   The effects are mostly good,  and for some plots, plotting 
  495. time  is cut in half.   Optimizing the data file itself is  desirable.  
  496. The  loading of fonts on a slow system or from floppy disks takes lots 
  497. of time.   Don't digitize a few entries that use font #1,  then a  few 
  498. more  that use other fonts.   Optimizing a data base using the utility 
  499. program GSMUTIL takes thought but only a few minutes to order  entries 
  500. to minimize font switching and pen swapping.   
  501.  
  502.      If moving from Version 6.0 level programs,  print the first lines 
  503. of each of your Version 6 configuration files;  change the first lines 
  504. of the Version 8 configuration files with the same name to match those 
  505. of the Version 6 file.   You will notice that CONFIG8.SCR is the same;  
  506. the keypad version of CONFIG8.DIG needs one additional line to  define 
  507. the  F  key;   CONFIG8.PLT  now  contains a  the  first  line  setting 
  508. communication  parameters,  a second that sets parameters for the size 
  509. of  label characters and circles for beginnings and ends of  lines  in 
  510. draft  mode,  and  18 lines establishing patterns and spacings for  18 
  511. line  types,  but not the symbol definitions.   The  file  CONFIG8.SYM 
  512. contains  symbol definitions formerly in CONFIG.PLT.   After  changing 
  513. the  first  lines  of  these files to  match  your  system,  copy  the 
  514. executable  files  (extension  .EXE into your  Level  8  subdirectory.   
  515. Level   8  programs  will  work  with  either  Cartesian  or  geodetic 
  516. coordinates, just decide which you want and be consistent.  
  517.  
  518.      Remember  to include the entire file name for text and data files  
  519. with extension in its proper place in the plot file,  and include  the 
  520. drive  designation  if you are operating with the program in one  area 
  521. and  text or data files in another.   Use of font #0 until  the  final 
  522. stages  of  preparation  of  hard copy will minimize  the  time  spent 
  523. loading fonts.   Yes,  fonts are now loaded during digitizing so  that 
  524. you  can  read the text on the screen.   Digitizing and editing  using 
  525. GSMAP  and  GSMEDIT may benefit from draftmode plot control  files  so 
  526. that  you can use the circles that mark the first and last  points  of 
  527. lines on the screen.  
  528.  
  529.      Preparation  or review of these files will require that you  plan 
  530. codes,  text,  and  data,  and  that  you  DO  your  homework  on  map 
  531. projections  if using geodetic coordinates.   If a code is left out of 
  532. the plot control file,  entries with that code won't be plotted to the 
  533. screen or on the hard copy (Option 8), but will be shown on the screen 
  534. when  digitizing  Option 3 GSMAP,   but as   decorated  or  patterned, 
  535. symbols  and text entries will show as points (no text,  no  symbols).  
  536. On EGA or VGA color screens these lines will be seen in bright yellow. 
  537.  
  538. Mouse
  539.      A  mouse  can  be  used as a pointing device  with  the  graphics 
  540. screens of GSMEDIT,  GSMPBS,  and GSPOST.   Microsoft-compatible mouse 
  541. driver   software  must  be  installed  (see  instructions  in   mouse 
  542. documentation),  and loaded,  generally a function of instructions  in 
  543. the  CONFIG.SYS  file before opening one of these programs  in  mouse-
  544. mode.   With these programs the Microsoft-compatible mouse can be used 
  545. to move about the graphics screen and locate points, not for choice of 
  546. option.
  547.  
  548.      In  general,  select  options using hot keys on the keyboard  (no 
  549. ENTER keystroke required),  use the mouse to move the cursor about the 
  550. screen instead of using the arrow keys on the keyboard (as used in the 
  551. keyboard  mode  of operation),  and use the left key on the  mouse  to 
  552. select  a  location.   If for example,  you want to set  a  window  to 
  553. enlarge  a portion of the screen,  hit B on the keyboard to select the 
  554. "set  window option",  use the mouse to move the cursor to  the  lower 
  555. left  corner of the window to be selected,  press the left  key,  then 
  556. move  the  mouse cursor to the upper right corner of the  window,  and 
  557. press the left key to establish the second corner of the window.  
  558.  
  559.      In the input mode,  GSMEDIT, the "arrow key" digitizing procedure 
  560. requires the use of the 0, 1, 2, and 3 keys to specify function.  With 
  561. the  mouse,  click the left key instead of the 0 key on the  keyboard, 
  562. click the right key to return operation to the keyboard,  then hit the 
  563. the  1,  2,  or 3 key on the keyboard to specify the function  of  the 
  564. right-key stroke.  This resembles the procedure required for operation 
  565. of GSMAP with a one-key digitizer, where a return to the menu template 
  566. is   required  to  specify  the  function  of  the  last   key-stroke.  
  567. Digitizing a closed rectangular polygon in mouse-modewould require,  L 
  568. click,  L  click,  L click,  R click,  hit 2 key on the keyboard.   In 
  569. mouse-mode, the keyboard instruction tells GSMEDIT the function of the 
  570. final right click from the mouse.
  571.  
  572. Plot Register
  573.  
  574.      A word of caution about the PR plot register option introduced in 
  575. Version 8 of GSMAP and GSPOST so that a plotter can be used to make  a 
  576. plot registered to corners drawn on the sheet,  i.e.,  here's a way to 
  577. draw  a geologic map on a paper copy of the topographic  base.    This 
  578. process  uses a temporary HPGL file (created then deleted).   Although 
  579. you won't ever see this file,  space must be available on the  working 
  580. drive  so that the computer can create and use it.   For this  reason, 
  581. use  a directory with plenty of space on your fastest drive.   Some of 
  582. these  HPGL files can be large,  very much larger than the  data  base 
  583. files.   One  of  ours for a complete and patterned 15' quadrangle  is 
  584. over one Megabyte in size.  This PR process isn't practical when using 
  585. floppy disks, except for small projects.
  586.  
  587. SECTION 7 - ADVICE FOR NEW USERS
  588.  
  589.      Don't fight hardware and new software at the same time.   If  you 
  590. are setting up a new system,  use the sample BASICA  programs provided 
  591. in  the  documentation  to help establish communication  between  your 
  592. computer,  digitizer,  and plotter.   Read the section on installation  
  593. and configuration files starting p.  155 before blindly attempting  to 
  594. run the Tutorial.   You will need to customize the configuration files 
  595. named CONFIG8.SCR, CONFIG8.PLT, and CONFIG8.DIG to match your system's 
  596. hardware.   If  you  do not install as per instructions in Section  2, 
  597. make  sure that your PATH contains the directory where the  executable 
  598. programs  were  loaded.   If  you chose not  to  use  the  environment 
  599. variable GSFILES,  then the files named CONFIG8.*, *.FNT, and possibly 
  600. the   executable  files  (extension  .EXE)  must  be  in  the  default 
  601. directory. 
  602.  
  603.      Read the section on map projections and projection files.  If you 
  604. do,  you won't expect the sample projection file MAP.PRJ designed  for 
  605. maps  using the UTM projection in Colorado to work correctly for  your 
  606. rush project in the Empty Quarter.Start with the glossary,  it has all 
  607. the good stuff.   After the system is working, spend a couple of hours 
  608. doing the GSMAP tutorial project.  You'll save time in the long run.  
  609.  
  610.      Make   copies  named  CONFIG8.*.   These  will  work.   Read  the 
  611. configuration instructions, and make use of the environmental variable 
  612. SET GSFILES=  ,  see p. 155 of the documentation to simplify your hard 
  613. disk's configuration.
  614.  
  615.      The   GSMEDIT program is one of the best ways of plotting a  data 
  616. base on the screen because you can see details of parts of the data by 
  617. using its windowing  capabilities;  a  digitizer isn't  required   for  
  618. windowing.  An  early  use  of  the  F9  Q  key sequence  (terminating 
  619. the  screen  plot  early) when drawing to the screen  greatly   speeds  
  620. operations.  GSMEDIT requires a plot control file.   In addition,  you 
  621. can digitize entries using this program.
  622.  
  623. Interconnection of hardware
  624.  
  625.      Please refer to the Installation section of the documentation for 
  626. such  details  as we can supply and a worksheet  (p.  156)  to  assist 
  627. configuration  of  the system.   Manuals supplied  with  the  hardware 
  628. furnish   additional   explanations   of   switch   settings,    cable 
  629. specifications, and details about interconnection and configuration of 
  630. particular pieces of hardware.  
  631.  
  632. Default Values
  633.  
  634.      At many points in the programs described here ,  prompts indicate 
  635. choices that have default values (hit the ENTER key).  Default choices 
  636. are indicated in Upper case letters;  lower case letters designate the 
  637. other valid choices.
  638.  
  639. Mouse
  640.      A  mouse  can  be  used as a pointing device  with  the  graphics 
  641. screens of GSMEDIT,  GSMPBS,  and GSPOST.   Microsoft-compatible mouse 
  642. driver   software  must  be  installed  (see  instructions  in   mouse 
  643. documentation),  and loaded,  generally a function of instructions  in 
  644. the  CONFIG.SYS  file before opening one of these programs  in  mouse-
  645. mode.   With these programs the Microsoft-compatible mouse can be used 
  646. to move about the graphics screen and locate points, not for choice of 
  647. option.
  648.  
  649.      In  general,  select  options using hot keys on the keyboard  (no 
  650. ENTER keystroke required),  use the mouse to move the cursor about the 
  651. screen instead of using the arrow keys on the keyboard (as used in the 
  652. keyboard  mode  of operation),  and use the left key on the  mouse  to 
  653. select  a  location.   If for example,  you want to set  a  window  to 
  654. enlarge  a portion of the screen,  hit B,on the keyboard to select the 
  655. "set  window option",  use the mouse to move the cursor to  the  lower 
  656. left  corner of the window to be selected,  press the left  key,  then 
  657. move  the  mouse cursor to the upper right corner of the  window,  and 
  658. press the left key to establish the second corner of the window.  
  659.  
  660.      In the input mode,  GSMEDIT, the "arrow key" digitizing procedure 
  661. requires the use of the 0, 1, 2, and 3 keys to specify function.  With 
  662. the  mouse,  click the left key instead of the 0 key on the  keyboard, 
  663. click the right key to return operation to the keyboard,  then hit the 
  664. the  1,  2,  or 3 key on the keyboard to specify the function  of  the 
  665. right-key stroke.  This resembles the procedure required for operation 
  666. of GSMAP with a one-key digitizer, where a return to the menu template 
  667. is   required  to  specify  the  function  of  the  last   key-stroke.  
  668. Digitizing a closed rectangular polygon in mouse-modewould require,  L 
  669. click,  L  click,  L click,  R click,  hit 2 key on the keyboard.   In 
  670. mouse-mode, the keyboard instruction tells GSMEDIT the function of the 
  671. final right click from the mouse.
  672.  
  673. Plot Register
  674.  
  675.      A word of caution about the PR plot register option introduced in 
  676. Version 8 of GSMAP and GSPOST so that a plotter can be used to make  a 
  677. plot registered to corners drawn on the sheet,  i.e.,  here's a way to 
  678. draw  a geologic map on a paper copy of the topographic  base.    This 
  679. process  uses a temporary HPGL file (created then deleted).   Although 
  680. you won't ever see this file,  space must be available on the  working 
  681. drive  so that the computer can create and use it.   For this  reason, 
  682. use  a directory with plenty of space on your fastest drive.   Some of 
  683. these  HPGL files can be large,  very much larger than the  data  base 
  684. files.   One  of  ours for a complete and patterned 15' quadrangle  is 
  685. over one Megabyte in size.  This PR process isn't practical when using 
  686. floppy disks, except for small projects.
  687.